home *** CD-ROM | disk | FTP | other *** search
/ Software 2000 / Software 2000 Volume 1 (Disc 1 of 2).iso / aga / aga136.dms / in.adf / smc / ScreenModeChanger.doc < prev    next >
Encoding:
Text File  |  1993-02-01  |  4.4 KB  |  99 lines
  1.   *------------------------------*
  2.  /                              /|
  3. *------------------------------* |
  4. | Prg.name : ScreenModeChanger | | 
  5. | Date     : 02.02.1993        | *-----------------------*
  6. | Language : Oberon            |/                       /|
  7. *------------------------------*-----------------------* |
  8. |     ----  Copyright Tom Kroener                      | |
  9. |    /(c)|            Richard Wagner Str. 40           | |
  10. |   / TKs|            D-6602 Saarbruecken-Dudweiler    | |
  11. |  / 1991|            GERMANY                          | |
  12. | --------                                             | |
  13. |             e.Mail: thkro@stud.uni-sb.de (internet)  | |
  14. |                     kroener@cs.uni-sb.de (internet)  | |
  15. |                     TKROENER@OUTWORLD.ZER (Zerberus) | *----------*
  16. |                                                      |/          /|
  17. *------------------------------------------------------*----------* |
  18. | ScreenModeChanger is NOT public-domain.                         | *
  19. | It may not be used in commercial products without my permission |/
  20. *-----------------------------------------------------------------*
  21.  
  22. I want to thank Nico Francois for his great 'reqtools.library' and
  23. Kai Bolay for his 'NTSC4NTSC' which gave me the idea how to make
  24. ScreenModeChanger and from which I have used parts of the patching
  25. routine.
  26.  
  27.  
  28. 1.What is ScreenModeChanger ?
  29. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  30.   ScreenModeChanger (short SMC) is a small tool to patch the Openscreen-
  31.   functions of OS2.04 (and newer) to force other programs to open their
  32.   screens in the (with SMC) selected screenmode.
  33.   SMC can be used only under OS2.04 and newer!
  34.  
  35.  
  36. 2.Why ScreenModeChanger ?
  37. ~~~~~~~~~~~~~~~~~~~~~~~~~
  38.   With OS2.04 and OS3.0 the user can select different screenmodes.
  39.   Some modes are not visible on all monitors (some may even destroy
  40.   the monitor), and it's very annoying to have a nice VGA-monitor (like
  41.   me) and most programs open a PAL- or NTSC-screen.
  42.   SMC allows an easy selection (via mouse) of the screenmode which is 
  43.   used to patch the Openscreen-function.
  44.  
  45. 3.Installation of ScreenModeChanger :
  46. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  47.   SMC needs the 'reqtools.library' (© Nico Francois) to work.
  48.   Start the program 'Install_reqtools.lib' before the first start
  49.   of SMC to install this library on your disk.
  50.   SMC can be copied like other programs via Workbench/Shell to your
  51.   prefered destination.
  52.  
  53. 4.How to use ScreenModeChanger:
  54. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  55.   SMC can be used from Workbench and from the Shell. If it finds the
  56.   file 'ENV:SMC.prefs' it tries to load and use it for the preferences.
  57.   If 'ENV:SMC.prefs' doesn't exist it opens a ScreenMode-requester and
  58.   you can select the screenmode via mouse.
  59.   This requester can be forced with the '-r' option when starting SMC
  60.   from Shell.
  61.   After selecting the mode, the file 'ENV:SMC.prefs' will be updated
  62.   and SMC will find this information everytime it is started.
  63.   After that, a small window will be opened on the workbench to show that
  64.   SMC is running and to allow you to remove SMC from the system.
  65.   When this small window has been moved, the coordinates are also saved
  66.   to 'ENV:SMC.prefs' when removing SMC.
  67.  
  68. 5.Some remarks:
  69. ~~~~~~~~~~~~~~~
  70.   - SMC can open screenmodes which may destroy your monitor; be careful
  71.     and read the manuals of your monitor/Amiga before using SMC.
  72.   - If you have started more than one program that patches the OpenScreen
  73.     -functions be shure to finish them in the reversed order.
  74.   - You can only run ONE SMC at the same time.
  75.   - Start SMC, start other programs and remove SMC will not change the
  76.     modes of other programs; programs started with different patches
  77.     are also possible (but you have to restart SMC to change the patch-
  78.     mode!).
  79.   - SMC works on my system with all tested programs; maybe a program
  80.     can't be used in a mode with less colors (you may see no texts
  81.     or gadgets) but using the right palette (if it can be changed)
  82.     often helps.
  83.   - Programs using sprites or with genlock compatiblity can't work
  84.     in screenmodes which don't allow sprites/genlocks!
  85.  
  86.   SMC is tested under OS2.04 and had never crashed (even tested with
  87.   very old BASIC-programs and things like DPaint and Shanghai) but
  88.   if you have trouble give me a small note (adress see above).
  89.  
  90.   SMC is not shareware, but sending money or other things could be a
  91.   good idea...  (A4000 prefered)
  92.  
  93. Enjoy
  94.  
  95.        --- Tom 
  96.  
  97.  
  98.  
  99.